/**
 *    Copyright (C) 2007-2009 DIVIS GmbH (http://www.divis-hagen.de/)
 * 
 *    This library is free software; you can redistribute it and/or
 *    modify it under the terms of the GNU Lesser General Public
 *    License as published by the Free Software Foundation; either
 *    version 3 of the License, or (at your option) any later version.
 * 
 *    This library is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *    Lesser General Public License for more details.
 * 
 *    You should have received a copy of the GNU Lesser General
 *    Public License along with this library; if not, write to the
 *    Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 *    Boston, MA 02110-1301 USA
 */

package de.divis_hagen.json;

import java.io.OutputStream;
import java.io.Writer;


/**
 * <p>
 * A <code>Marshaller</code> writes objects to JSON streams.
 * </p>
 * <p>
 * Use {@link JSONContext} to acquire a marshaller.
 * </p>
 *
 * @author Aike J Sommer
 * @see JSONContext
 */
public interface Marshaller {

    /**
     * Write <code>Object o</code> to <code>OutputStream out</code>.
     * 
     * @param o The object to be marshalled.
     * @param out The stream <code>o</code> should be marshalled to.
     * @throws de.divis_hagen.json.JSONException
     */
    void marshall(Object o, OutputStream out) throws JSONException;

    /**
     * Write <code>Object o</code> to <code>Writer out</code>.
     * 
     * @param o The object to be marshalled.
     * @param out The writer <code>o</code> should be marshalled to.
     * @throws de.divis_hagen.json.JSONException
     */
    void marshall(Object o, Writer out) throws JSONException;

}
